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with Fortran subprograms, the relocatable modules 
required to run with cobol and Fortran object pro- 
grams must be in the same Relocatable Library. 

9. Every system must have the Bootstrap, the Resi- 
dent Monitor, and the Transitional Monitor (in that 
order ) at the beginning of the tape. 

10. The maximum number of items that may appear 
on an sof is 154. An item is defined as a program or a 
library. (Examples: cobol is one item and ibmlibr is 
one item. ) 

11. Table 1 indicates the asgn cards that are required 
during System Generation. 

12. The Generalized Tape Sorting Program requires 
a minimum of four tape units (including the sof). 



These may be the same tape units as those used as 
work files by compilers. Additional tape units increase 
the program's efficiency. See the publication General- 
ized Tape Sorting Program. 

13. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 

14. Programs that require the Autocoder "No-Clear" 
option for da statements must not be placed on the sof. 

15. Programs on the sof cannot contain a phase in- 
tended to modify, through loading from the sof, a 
previous phase. 



Table 1. Tape System Input/ Output Requirements 
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* For the minimum configuration, MW3 and MJB, and MGO and MRO share the same physical units. 
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Basic Concepts — Disk-Oriented System 



This section applies only to a disk-oriented system and 
need not be read by persons interested only in a tape- 
oriented system. 



How the System is Built 



The output, in absolute form, is placed onto the 
Job file, mjb. 

SG2: This program locates and copies the library 
elements that the user desires in the new system. Its 
output is a new tape that is capable of being loaded 
onto the disk. This tape contains all items generated. 



Functions to be Performed 

The Master file contains a bootstrap disk load program 
that loads the Master file on the disk in preparation 
for System Generation. The absolute portion that is 
loaded on the disk is capable of building an sgf. The 
sgf incorporates those options desired by the user. To 
build the sgf, several programs from the operating 
section, which are in absolute format, are executed. 
These programs perform the following functions: 

1. Accept input data that describes the environment 
within which the new system is to operate, and in- 
corporate the optional items defined by each user. 

2. Build absolute programs that the user specifies. 

3. Place these absolute programs on the output file. 

4. Place the library elements on the output file. 

Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and the various options available in the 
form of Autocoder source statements. Autocoder proc- 
esses this input by means of macro routines and gen- 
erates the nucleus of the new system. 

SGI: This program performs one function. It pre- 
pares a tape which contains input control information 
for the Linkage Loader (linkload program). 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 
work tape produced by sgi and/or control cards from 
the siu. The relocatable input that it processes comes 
from: 

1. The output of the Autocoder run (item 1 above); 
and 

2. The Relocatable Library supplied on the Master 
file. (This library must have been loaded onto the 
disk.) 



Defining the System 

The user must describe the Operating System that he 
desires through control cards. A detailed description 
of the control cards appears in "System Description 
Control Cards" and "System Generation Control 
Cards." 

Briefly, the user supplies the following: 

1. The number and types of input/output devices. A 
two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic unit entries 
required. 

4. The variable and optional features desired within 
the Resident iocs. 



Preparing to Build an SGF 

Before building an sgf or sof, it is necessary for the 
user to load the Master file or the source sgf onto disk 
storage. Instructions for performing this transfer to 
disk storage are given in "Disk Load Program." 

After the Master file is loaded onto the disk, it is 
necessary to format the disk areas required for the 
files (mjb, mgo, mwi, MW2, and MW3) used during 
System Generation. This is accomplished by using the 
1301 or 2302 Format/ Address Generator utility pro- 
grams. See the publication IBM 1410/7010 Operating 
System; Utility Programs, Form C28-0353, for instruc- 
tions in the use of these programs. 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
sgf run. 
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General Maintenance Considerations 

Maintenance of the Operating System covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the sgf, sof, all Job files that have been saved, 
and all tp Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of affected modules, 
copying (incld) any unaffected programs, and re- 
generation of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating section which 
were affected. As in above item, any unaffected pro- 
grams can be copied by use of the incld card. By care- 
ful planning, the user should be able to make changes 
to an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions of the operation 
of the Go file during maintenance of the Relocatable 
Library. Refer to Class iv control cards inser and 
replc, under "System Generation Control Cards." 

Instead of the above method, the SG4 and sgs pro- 
grams can be used to update the libraries, as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm supplies a tape 
containing the changes to be made. This tape is used 
with the sgs program to prepare an input tape for up- 
dating the libraries. The program has an option that 
permits it to be used with a minimum disk system 
having only one tape unit available to the Operating 
System program. If the user must make his own 
changes to ibm program modules, he can use the SG4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities effi- 
ciently. 

Check List for System Generation 
(Disk-Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The Sort Definition program should be gener- 
ated by the initial generation if sort or merge programs 
are to be created on an sof. 

3. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 



Relocatable Library can also be modified. The library 
must be loaded onto the lib file when the system is 
loaded on the disk. 

4. cobol and Autocoder use symbolic units mwi, 
mw2, and mw3 for work files during compilation; For- 
tran uses mwi and mw2. mwi and MW3 should be 
assigned to a different channel and/or module from 
mw2 for balanced and efficient usage of the 1301 disk. 

5. The Create Library must be named creatlib, and 
the Macro Library must be named macrolib. 

6. If the cobol "enter" verb is used in conjunction 
with Fortran subprograms, the relocatable subpro- 
grams required to run with cobol and Fortran object 
programs (refer to "Relocatable Library Contents") 
must be in the same relocatable library. 

7. The order of elements on the disk is of little im- 
portance because of the random access nature of the 
device. However, the placement of some of the ele- 
ments on the output tape, which contains the system, 
can be critical, and the following points should be 
observed: 

a. The first program on the tape must be ibsgdl. 
This is the Disk Load program. 

b. The second program must be ibboot. bbboot, 
for a disk-oriented system, comprises a boot- 
strap program (ibboot2d), the Resident Moni- 
tor, and the Transitional Monitor. 

c. The remaining programs may be in any order 
if they have been included from an existing 
sgf. If the system that is being built is to be 
capable of generating another system, ibsgdl 
must be included again. 

d. If an entire system is being generated, ibsgdl 
must be generated as the first program. Also, 
if the entire system being generated is to be 
capable of generating another system, then the 
ibsgdl program must also be generated last. 

8. Table 2 indicates the asgn cards that are required 
during System Generation. 

9. The Generalized Tape Sorting program requires 
a minimum of four tape units (including the sof). 
Additional tape units increase the program's efficiency. 
See the publication Generalized Tape Sorting Pro- 
gram. 

10. Each initialization of a disk system requires that 
the booti card be first in the siu. The contents of this 
card are typed on the console printer during system 
loading. The operator key punches the card and places 
it in the siu. 

11. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
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requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 



Storage. 



12. Programs that require the Autocoder "No-Clear" 



option for da statements should not be placed on the 



SOF. 



13. Programs on the sof cannot contain a phase in- 
tended to modify, through loading from the sof, a 
previous phase. 



Table 2. Disk System Input/ Output Requirements 
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* To insert Directory 3 
** To insert the Macro Library 

| NOTE: The Macro Library cannot be placed on a Job file. 



COBOL: Relocatable Library Modules for Object 
Programs 

The following modules are required by cobol object 
programs: 
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FORTRAN: Relocatable Library Modules for Object 
Programs 

Required Modules 

The following modules are required to run with any 
fortkan object program: 
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Optional Modules 

The following modules are not required by a Fortran 
program unless they are called by name in the source 
program. Inclusion of these modules is therefore an 
installation option, except (as noted) the selection 
of one optional module may require another. 
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Floating-Point Arithmetic Modules 

The four modules supporting floating-point arithmetic 
are on the Relocatable Library of the Master file in 
the following order: 

POSITION NAME REMARKS 

1 IBINTRP For programmed interpretation of 

floating-point instructions. 

2 OVERFL "| For machine interpretation of 

3 DVCHK V floating-point instructions (on an 

4 IBINTRP J IBM 7010 with the Floating-Point 

Arithmetic feature ) . 

To obtain the modules supporting the 7010 Float- 
ing-Point Arithmetic feature, the following card should 
be used: 

6 16 21 

IBINTRP DELET R 

To obtain the modules that provide programmed 
interpretation for floating-point instructions, use this 
card: 
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OVERFL DELET R.IBINTRP 
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SGI and SG2 Diagnostic Messages 



The sgi and SG2 diagnostic messages are listed in this 
section with an explanation of the message and sug- 
gested corrective action for: (1) tape-oriented systems, 
and (2) disk-oriented systems. 



Tape-Orient ed System 

Diagnostic messages that may be produced on the con- 
sole printer during execution of sgi and SG2 are listed 
in sequence by message number in the following sec- 
tion. When one of these messages appears, processing 
halts and special end of program occurs unless the 
"Corrective Action" comment states that processing 
will continue or that no corrective action is to be taken. 
After the correction is made, the job must be rerun. 
Full instructions appear in the publication, Operators 
Guide. 

SGI and SG2 Diagnostic Messages for a Tape-Oriented 
System 

11501 XXXXXXXXXX NOT ON TAPE 

Explanation: Request has been made for the named 
item but it cannot be located on the SOF or on the 
Relocatable or Create Library. 

Corrective Action: Check control deck for proper call 
and/or spelling, etc. 

11502 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number has 
been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

1 1503 DIRECTORY X NOT AVAILABLE 
Explanation: X can be "1" or "3." 

Corrective Action: Check the control deck to make sure 
directory has been generated previous to this reference. 
If X is not 1 or 3, the PHASE card for the directory has 
been mispunched. 

11504 XXXXXXXXXX LIBRARY NOT AVAILABLE 
Explanation: Request has been made for the named 
library but that library cannot be located or does not 
exist. 

Corrective Action: Check the control deck to make sure 
that a library of the name XXXXXXXXXX has been 
copied, updated, or added by SGI. 

11505 NEW SOF ON XXX 

Explanation: XXX is the x-control field for the unit 
on which the System Generation output file is located. 
Corrective Action: None. 

11507 LIB TYP UNKNOWN 

Explanation: Request has been made for a library 
whose type is not M, R, or C. 

Corrective Action: Check control deck. The PHASE 
card for the library header may have been punched 



incorrectly. The M, R, or C must be in column 62 of 
the PHASE card. 



11508 BACKSPACE FAILURE 
Corrective Action: Restart. 



SOF 



11509 BACKSPACE FAILURE - MJB 
Corrective Action: Restart. 

11510 NEW LIBRARY ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new library is located. 
Corrective Action: None. 

11511 UNKNOWN HDR TYP 

Explanation: Header record is not proper format. 
Corrective Action: Check control deck. Check that all 
the libraries processed by SGI were done in one block 
and were processed before absolute programs. Also 
check that no conflict exists in input/output assignments. 

11512 NO TYPC COUNTS 

Explanation: Specific cause has not been determined. 
Corrective Action: Check control deck for extraneous 
PHASE cards, order of cards, etc. 

11513 EXTRANEOUS HEADER 

Explanation: Record descriptions contained on MW1 
(header records) do not agree with contents of Job file. 
Corrective Action: Ensure that all requests for SGI to 
INSER, DELET, REPLC, and ADD library material 
were made prior to requests to process absolute format 
records. Also check that no conflict exists in input/out- 
put assignments. 

11514 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11515 MODULE XXXXXXXXXX NOT ON GO TAPE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11516 SOF RECORD TOO LARGE TO COPY 

Explanation: SGI, when working with largest possible 
records, cannot copy an SOF on a smaller machine than 
was used to generate the SOF. 

Corrective Action: The records on the SOF cannot be 
copied on the size machine being used, with SGI based 
where it is. Regeneration of the SOF is necessary. 

11517 NO ALTERNATE LIBRARY HEADER 
Explanation: SGI has been directed to find an external 
library, but did not find an identifying header record 
on LIB. 

Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11518 (No message) 

Explanation: A macro routine or a model statement has 
been specified, but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SGI may be out of sequence. 



SGI and SG2 Diagnostic Messages 71 



Form C28-0352-5 
Page Revised 12/30/66 
By TNL N27-1270 



11519 MACRO DIR EXCEEDS 240 

Explanation: The Macro Library can have only 240 
entries, and this number has been exceeded. 
Corrective Action: Reduce number of macro routines to 
specified limit. 

11520 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were followed 
by an END card. No action is required if all other cards 
are in order. 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates 
a header is desired on the output tape. The card follow- 
ing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2." 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11523 SOF EXCEEDS 154 LIMIT 

Explanation: Tape SOF may have no more than 154 
items, and this number has been exceeded. 
Corrective Action: Deck may be in error. Some items 
may have been copied several times. 

Disk-Oriented System 

Diagnostic messages that may be produced on the 
console printer during execution of sgi and SG2 are 
listed in sequence by message number in the follow- 
ing section. When one of these messages appears, 
processing halts and special end of program occurs 
unless the "Corrective Action" comment states that 
processing will continue or that no corrective action 
is to be taken. After the correction is made, the job 
must be rerun. Full instructions appear in the Oper- 
ator's Guide. 

SGI and SG2 Diagnostic Messages for a Disk-Oriented 
System 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates a 
header is desired on the output tape. The card fol- 
lowing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2". 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11562 CREATLIB NOT ON SOF 

Explanation: SGI has been executed, but the Create 
Library is not on the system. 

Corrective Action: An SOF that includes the Create 
Library must be generated and this SOF used to proc- 
ess the job that caused the message. 

11563 PACKAGE XXXXXXXXXX NOT IN CREATLIB 
Explanation: No packet of the name XXXXXXXXXX 
has been found in the Create Library by SGI. 



Corrective Action: Check the control deck to be sure 
that spelling on CREAT card is correct. 

11564 OUTPUT ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new output file is located. 
Corrective Action: None. 

11565 DISK LOADER NOT PRESENT 

Explanation: IBSGDL has not been included or gener- 
ated as the first item. 
Corrective Action: Rerun the job including IBSGDL. 

11566 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were fol- 
lowed by an END card. No corrective action is neces- 
sary if all other cards are in order. 

11567 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11568 (No message) 

Explanation: A macro routine or a model statement has 
been specified but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SG2 may be out of sequence. 

11569 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number 
has been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11570 ALTERNATE LIBRARY HEADER 

Explanation: SG2 has been directed to find a library 
but did not find an identifying header record on LIB. 
Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11571 MODULE XXXXXXXXXX NOT ON GO FILE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11572 XXXXXXXXXX NOT AVAIL 

Explanation: An INCLD card has specified the name 
of an item which is not in the system. 
Corrective Action: Check control deck for proper spell- 
ing of item name. 

11573 XXXXXXXXXX NOT VALID 

Explanation: An INCLD card has specified the name 
of an item which does not contain valid program infor- 
mation. The area assigned to SOF (on the disk) has 
been accidentally altered or destroyed. 
Corrective Action: Reload the SOF from the output tape 
from the previous System Generation run. 

1 1574 SG2 CTL CARD OR 1/ O ERROR 

Explanation: An uncorrectable I/O error has occurred. 
The problem may be caused by erroneous system gener- 
ation control cards. 
Corrective Action: Check the deck and rerun. 
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